home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / boot / !Boot / Resources / Configure / !InetSetup / !Help < prev    next >
Text File  |  1997-12-15  |  4KB  |  97 lines
  1. Internet Setup
  2. ==============
  3.  
  4. InetSetup is used to configure the TCP/IP network stack built into RISC OS
  5. 3.7.
  6.  
  7. Together with the new Internet application (which is contained within !Boot),
  8. it replaces the functionality of the old !Internet and !BootNet that
  9. were available separately for previous versions of RISC OS.
  10.  
  11. For information on how to use InetSetup, see the RISC OS 3.7 release note.
  12. Extensive interactive help is available - press the Help button in
  13. InetSetup's main dialogue box.
  14.  
  15.  
  16. Troubleshooting
  17. ---------------
  18. You may find that some options are greyed out. This will be because some
  19. required software has not been found in your ROMs or in your System
  20. application.  Some options (eg Reverse ARP and RouteD) will only be available
  21. if you have the full TCP/IP Protocol Suite.
  22.  
  23. No name resolver is supplied with this edition of RISC OS, but InetSetup
  24. is aware of four of the available name resolvers:
  25.  
  26.          Resolve from Gnome Computers
  27.          Resolver from ANT
  28.          InetDB by Adam Goodfellow
  29.          DNSResolver by Stewart Brodie
  30.  
  31. If InetSetup detects any of these in your System application it will allow
  32. you to select one and configure it in the Hosts dialogue box.
  33.  
  34.  
  35. What InetSetup does
  36. -------------------
  37. InetSetup scans both the ROM and the System directory of your computer to
  38. find available network modules. It also autodetects network cards fitted to
  39. your computer. It then offers configuration dialogue boxes for the available
  40. network software and hardware.
  41.  
  42. When the Save button is clicked:
  43.  
  44.      1) InetSetup checks that all settings are consistent.
  45.      2) Obsolete and duplicate network modules are unplugged.
  46.      3) Required network modules are inserted if available in ROM.
  47.      4) !Internet's configuration files are updated, if the TCP/IP
  48.         Protocol Suite is enabled.
  49.      5) A SetUpNet obey file is placed into your !Boot directory
  50.         to ensure that the networking software is run on startup.
  51.      6) You are given the opportunity to restart your computer.
  52.  
  53.  
  54. Technical details
  55. -----------------
  56. InetSetup is hardwired with details of common network interfaces. To add an
  57. unknown interface to InetSetup's interface list, place a detection program in
  58. !InetSetup.AutoSense. All files in the AutoSense directory are run before the
  59. InetSetup application starts. Your program should detect the presence of an
  60. interface (independently of its driver module being present - it may be
  61. unplugged), and for each interface present set a system variable
  62.  
  63.   InetSetup$Driver$<location>
  64.  
  65. <Location> is not significant, but is presented to the user in InetSetup,
  66. with underscores converted to spaces. Example locations are "NIC", "Slot_4"
  67. and "Econet".
  68.  
  69. The variable should be set to
  70.  
  71.     <description>:<unit>:<driver module>[:<version>[:<module filename>[:P]]]
  72.       
  73. where
  74.  
  75.       description = human-readable description of interface, eg
  76.                     "Ethernet III"
  77.       unit = DCI-4 driver name, eg "ea0"
  78.       driver module = name of driver module, eg "Ether3"
  79.       version = minimum version required for DCI 4.02 support, eg "4.21".
  80.                 If omitted, it is assumed that any version will do.
  81.       module filename = filename of driver module in System:Modules.Network,
  82.                         eg "Ether3-16". If omitted, it will not attempt to
  83.                         softload the module should it not be present in
  84.                         ROM.
  85.       P : if present, the interface is a point-to-point interface (PPP).
  86.  
  87. The required version numbers for the core networking modules are specified in
  88. InetSetup's Messages file. If, for example, you have Net 6.18 in ROM, but
  89. require Net 6.19, then you must set v_Net to 6.19 in the Messages file,
  90. otherwise InetSetup, when used, will RMInsert the Net from the ROM, and not
  91. cause the new Net module to be loaded on startup.
  92.  
  93. InetSetup currently generates the files Choices:Internet.Startup, and
  94. <Boot$ToBeLoaded>.SetUpNet. The other files in the Choices:Internet directory
  95. are intended to be manually edited.  Any changes made to the Startup or
  96. SetUpNet files will be lost when InetSetup next runs.
  97.